home *** CD-ROM | disk | FTP | other *** search
/ Visual Basic Source Code / Visual Basic Source Code.iso / vbsource / storc / storc.rme < prev    next >
Encoding:
Text File  |  1992-09-18  |  11.2 KB  |  306 lines
  1. ************************* Welcome to STORC v1.0! *****************************
  2. Distributors/Sysops: please refer to the end of this file for more information
  3.  
  4. In Short:     'STORC' stands for 'Screen-TO-Resource-Converter'.
  5.  
  6. Environment:     Microsoft Windows 3.x, Standard or Enhanced mode.
  7.  
  8. Purpose:    Converts any window on screen into a dialog resource script
  9.  
  10. Mission:    
  11.     Assists programmers in turning DEMOS written in Visual Basic(tm),
  12.     Object Vision(tm), Power Builder(tm) or any other prototyping tool
  13.     that stores forms in PROPRIETARY format into Windows 3.x
  14.     RESOURCE SCRIPTS!
  15.  
  16. Why Bother:     
  17.  
  18.     After you have created a Highly Polished Prototype using one
  19.     of the high-level tools and it is time to start working on the 
  20.     Real Thing... you probably found out that all your beautiful 
  21.     forms are stored in the format only readable by the tool itself!
  22.     Does that mean the time spent on aligning all those controls
  23.     is wasted forever and you have to start from scratch with a 
  24.     resource editor and a bunch of drawings?
  25.  
  26.     We hope NOT!!!
  27.  
  28. How it all started:
  29.  
  30.     When Visual Basic refused outright to yield us our forms, and we
  31.      had to deliver a number of pretty complicated converted forms and 
  32.     start coding in 2 days, we knew there is no way we could do this 
  33.     in time starting from scratch...
  34.  
  35.     Of course the boss did not know(now he does)...He actually got 
  36.     very happy with the results. Here is how we became heroes and not
  37.     losers: a simple conversion program! Yes! And all the forms got
  38.     converted in a couple of hours... 
  39.  
  40. More about STORC:
  41.  
  42.     Of course the STORC program we offer now is far more capable than
  43.     that original one. It was pretty difficult for anyone else but the
  44.     original author to figure out how to interpret results... Yes, it
  45.     is true that the original program was only converting control 
  46.     coordinates, and not always accurately.
  47.     
  48.     Now STORC also writes out dialog templates, interprets window styles
  49.     and reads in window texts. It has a little editor to help you modify
  50.     what you want, too. The output is ready to be processed by a dialog
  51.     editor (RC, Resource Workshop or any other) with minimal input on your 
  52.     side. And the result is... a dialog template exactly matching your
  53.     form(or any other window on the screen)!
  54.  
  55. Working with STORC 1.0:
  56.           
  57.     Suppose you have a Visual Basic demo product with some forms.
  58.  
  59.     Typically, you would run your demo and launch STORC.EXE.
  60.     To convert a form, you have to have it displayed on the screen,
  61.     so STORC can read it. When you see the form, activate STORC
  62.     and select Window/Find from its main menu. The mouse cursor will
  63.     turn into a special arrow with words 'find window' inside; then 
  64.     STORC minimizes itself to let you see your form. All you have to
  65.     do is click on the form window. Note: when you move the mouse above
  66.     windows, window borders are highlighted to indicate which window 
  67.     will get selected if you click; we recommend clicking on Caption 
  68.     Bars for accuracy. After you click, STORC restores itself with a 
  69.     resource script matching your form in its editor.
  70.      
  71.     You can perform this operation for any number of forms; every time
  72.     the resource script for the new form will be inserted into STORC 
  73.     editor at cursor.
  74.  
  75. More about STORC editor:
  76.      
  77.      The STORC application is built around an editor; its main window
  78.     is actually an edit field, and it has 'file' menu, 'edit' menu and
  79.     'find' menu provide basic functionality of a normal text editor.
  80.     This was done to assist in easy modification of your script.
  81.  
  82. Real-Life conversion options
  83.     
  84.     'Options/TranslateClasses' menu item
  85.  
  86.     As you know, you have to specify a CLASSNAME for every in the DIALOG 
  87.     script. For example, you say 
  88.         CTEXT "Text", -1, 7, 9, 75, 17, WS_CHILD| WS_GROUP
  89.     or (same thing):
  90.         CONTROL "Text", -1, "STATIC", WS_CHILD | WS_GROUP | SS_CENTER,
  91.              7, 9, 75, 17
  92.  
  93.     Many of the tools define their own control styles; for example
  94.     Visual Basic 1.0 defines custom control classes like "ThunderLabel"
  95.     or "ThunderListbox", etc.
  96.     If you decide to convert a form with custom controls to resources and
  97.     then run then from your program, you are likely to get into trouble.
  98.     You either have to use the custom control DLLs you tool uses(and use
  99.     them exactly as they were designed to be used) or provide a substitute
  100.     for custom controls, mapping their classes into standard Windows 
  101.     control classes or your own classes.
  102.  
  103.     STORC 1.0 gives you both options, controlled by 
  104.     'Options/TranslateClasses' menu item. When this menu item is checked,
  105.     the control classes will be translated as defined in [class translation] 
  106.     section of STORC.INI file(described below).
  107.     Otherwise you will see the original class names(which can be an 
  108.     educational experience).
  109.  
  110.     'Options/InterpretStyles' menu option
  111.  
  112.     A window style is a LONG integer value associated with a window.
  113.     It is logically divided into 2 words; high word contains WS_-type
  114.     styles shared by all window types. Low word is window-specific,
  115.     and its meaning is dependent on window class. 
  116.     If 'Options/InterpretStyles' is checked, STORC will make an attempt
  117.     to interpret BOTH parts of window style; of course it only knows
  118.     about styles of standard controls, so it will not interpret the lower
  119.     word of the window style unless 'options/TranslateClasses' is on and
  120.     it could map the control class into one of the standard classes.
  121.     It however would by all means attempt to interpret WS_ styles.
  122.     Uncheck this option if you would like to see a long integer for style
  123.     with no interpretation attempt
  124.  
  125.     'Options/Force Dlg Templates' menu option
  126.                                                
  127.     The DIALOG template allows you to specify CAPTION, CLASS and STYLE
  128.     for the dialog itself. If this menu option is checked, STORC
  129.     will get this information from the form window and put it into the
  130.     dialog template it writes.
  131.  
  132.     However, you will have to register the dialog class to use the 
  133.     resulting template; the custom class dialog style can be improperly
  134.     interpreted, and resulting dialog will be not usable unless you 
  135.     modify it.
  136.  
  137.     We decided to provide 'default' dialog template that definitely will
  138.     compile and run from any user's program. Check this option to 
  139.     force the 'standard' template. 
  140.  
  141. Configuration File Format:
  142.  
  143.     STORC uses the configuration file STORC.INI. The file has to be in 
  144.     the DOS PATH.
  145.     Here is a sample INI file with comments:
  146.  
  147.     ;STORC window coordinates (at time of last close):
  148.  
  149.     [rectangle] 
  150.  
  151.     left=0
  152.     top=0
  153.     right=640
  154.     bottom=480
  155.  
  156.     ;last 'options' menu parameters (at time of last close):
  157.  
  158.     [options]
  159.  
  160.     Translate Classes=0
  161.     Interpret Styles=1
  162.     Force Standard Templates=0
  163.  
  164.     ; classname translation
  165.     ; (this section will be used if 'Translate Classes' option is ON
  166.     ; every key is a 'custom' classname, and its value specifies how
  167.     ; it will be translated. All translations by default map into
  168.     ; standard Windows control classes, but you can change it so that
  169.     ; they map into YOUR custom classes, e.g. if you implement a
  170.     ; class 'BetterListbox' as an equivalent to Visual Basic 
  171.     ; 'ThunderListbox' class, change corresponding line to
  172.     ;    "ThunderListbox=BetterListbox"
  173.  
  174.     [classname translation]
  175.  
  176.     ;Visual Basic custom classes
  177.     
  178.     ThunderLabel=text
  179.     ThunderListbox=listbox
  180.     ThunderTimer=button
  181.     ThunderTextBox=edit
  182.     ThunderCheckBox=button
  183.     ThunderOptionButton=button
  184.     ThunderDriveListBox=listbox
  185.     ThunderDirListBox=listbox
  186.     ThunderFileListBox=listbox
  187.     ThunderFrame=button
  188.     ThunderCommandButton=button
  189.     ThunderComboBox=combobox
  190.     ThunderHScrollBar=scrollbar
  191.     ThunderVScrollBar=scrollbar
  192.     ThunderPictureBox=button
  193.  
  194.     ;Object Vision custom classes
  195.     OVButton=button
  196.     OVSubBar=button
  197.     OVToolBar=button
  198.             
  199.     ;end of STORC.INI
  200.  
  201. Terms:    This package is a DEMO of STORC 1.0, not the actual product! 
  202.     There are indeed some features disabled, and the purpose of 
  203.     this demo is to show you WHAT the actual program does, 
  204.     HOW it does it and WHAT    does the result look like. 
  205.     If you realize this is what you want, you are welcome to buy 
  206.     the actual program.
  207.  
  208.     
  209. How to Get the Real Thing:
  210.  
  211.     Just print out the order form (below) and send with a check to:
  212.  
  213.     PractiSys
  214.     4767 Via Bensa
  215.     Agoura, CA 91301
  216.  
  217.     CIS: 72010,567 (orders only, please)
  218.  
  219.      We are time-conscious and will mail you your copy on receipt of 
  220.     your check. 
  221.  
  222.     As an option, we can also E-MAIL you a copy using CompuServe mail.
  223.  
  224. Order Form:
  225.     
  226.     Yes, I want STORC 1.0.            
  227.     
  228.     Name_________________________________     STORC 1.0 .........$10.00
  229.     Phone(optional) (   )___-____ ext____    CA Tax.............$ _.__
  230.     Street_______________________________    Shipping/handling..$ 2.00
  231.     City______________State__ Zip________    =========================
  232.                         Total enclosed.....$__.__
  233.     
  234.             Thank you for your order!
  235.  
  236.                     **+**
  237.  
  238. Disclaimer:
  239.     PractiSys disclaims all the warranties relating to this 
  240.     software, whether express or implied, including but not 
  241.     limited to any implied warranties of merchantability and
  242.     fitness for a particular purpose, and all such warranties 
  243.     are expressly and specifically disclaimed. 
  244.     Neither PractiSys, nor anyone else who has been involved 
  245.     in the creation, production or delivery of this software
  246.     shall be liable for any indirect, consequential, or 
  247.     incidental damages arising out of use or inability to use 
  248.     such software even if PractiSys has been advised of the 
  249.     possibility of such damages or claims. In no event shall
  250.     the PractiSys' liability for any damages ever exceed the
  251.     price paid for the license to use the software.
  252.     Regardless of the form of claim, the person using the 
  253.     software bears all risk as to the quality and performance 
  254.     of the software.
  255.     Some states do not allow the exclusion of the limit of 
  256.     liability for consequential or incidental damages, so the
  257.     above limitation may not imply to you.
  258.     The agreement shall be governed by laws of state of 
  259.     California. Any action or proceeding brought by either 
  260.     party against the other arising out of or related to this
  261.     agreement shall be brought only in a STATE or FEDERAL COURT
  262.     of competent jurisdiction located in Ventura County, 
  263.     California.
  264.  
  265.                 --*--
  266.  
  267. File name:    STORC10.EXE        Archive:        LHA SFX
  268. Program name:     STORC             Version:        1.0D
  269. Classification:    DEMOWARE        Registration Fee:     $10
  270.  
  271. Publisher:    PractiSys, 4767 Via Bensa, Agoura, CA 91301
  272.  
  273. Packing List:
  274.     
  275.     STORC.EXE - main program
  276.     STORC.RME - this 'README' file
  277.     STORC.INI - STORC configuration file
  278.  
  279. Keywords:
  280.  
  281.     Windows, VisualBasic, ObjectVision, Resource, Form, Convert, Read
  282.     RC, RES, STORC, Screen
  283.  
  284. CONDITIONS UNDER WHICH THIS SOFTWARE CAN BE COPIED AND DISTRIBUTED:
  285.  
  286.     INDIVIDUALS can freely copy this software and share it with friends
  287.  
  288.     NON-PROFIT groups can distribute copies of this disk if they charge
  289.     no more than $5 per copy.
  290.  
  291.     DEALERS and DISK DISTRIBUTORS must obtain a written permission prior
  292.     to distributing copies of this software. They cannot charge more than
  293.     $10 per disk containing a copy of this program.
  294.  
  295.     By no means can any vendor/distributor modify the contents of any
  296.     file in this package. All files in the archive STORC10.EXE must be
  297.     distributed together.
  298.  
  299.     All vendors/distributors will immediately stop selling/distributing 
  300.     the software upon written notice from PractiSys
  301.  
  302.  
  303.  
  304.  
  305.                   - End -
  306.